home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-11 / fprotems.zip / PROPOPS.DOC < prev    next >
Text File  |  1993-01-04  |  4KB  |  73 lines
  1. PROPOPS.DOC
  2. PROPOPS Template documentation.
  3.             
  4. A UI2 Template c. Ellen J. Sander, 1989
  5.    
  6. Generates: Code for FoxPro user-defined popup menus.
  7.             
  8. Requires:  Named box(es) on the screen at generation time,
  9. with one or more options in it/them.
  10.             
  11. Function library used: Propops.TLB
  12.             
  13. Propops.TEM generates popup menus using the new DEFINE MENU...DEFINE BAR
  14. syntax, from boxes with menu options designed in the UI2 editor.
  15. ProPops.TEM requests a FoxPro COLOR SCHEME from the developer at generation
  16. time and uses this color scheme for all menus in the set.  A set of popup
  17. menus in a specific color scheme may then be developed a screenful at a
  18. time.
  19.             
  20. To define a FoxPro menu in the UI2 editor, create a box and enter a name
  21. for it in the Name slot of the box definition menu. Slot 1 in the menu
  22. box's definition menu is available for MESSAGE code. (aside: Is there a
  23. beter name to call that object?) Type the keyword MESSAGE and a quote-
  24. delimited "message string." If the expression gets long, (up to 79
  25. characters are legal in FoxPro) the template will split the line in the
  26. generated code  wherever you type a semi-colon in the slot.
  27.             
  28. PROPOPS.TEM supports two types of FoxPro popup menu objects:
  29.             
  30. 1.FIXED SIZE, MULTI-PROMPT POPUPS w/hard coded prompts
  31.             
  32. PROMPT, MESSAGE and SKIP code is generated when you create and
  33. attribute the menu as follows:
  34.             
  35. Create and size the menu box at the screen location where you want the
  36. menu to appear in your application.  Create prompts as options for the
  37. menu.  Type the prompt directly into the menu option on the design screen.
  38. In the menu option definition window, you may specify a message string for
  39. the prompt (messages are allowed for options as well as menus) in the
  40. dedicated Message String slot.  You may also (or alternately) enter any
  41. SKIP/SKIP FOR <logical condition> in the message slot in addition to any
  42. message text entered.  Do not enter a trigger character.  The trigger will
  43. automatically be the first character of the Prompt.
  44.             
  45. 2. VARIABLE SIZED POPUPS using fields or files as prompts
  46.             
  47. Popup menus using PROMPT FIELD, FILES/FILES LIKE...  STRUCTURE will be
  48. generated if you design the popup as follows:
  49.  
  50. Draw the box on the screen with the upper left corner positioned where you
  51. want the popup menu to start.  The size and shape of the box on screen are
  52. insignificant; at run-time the menu will size itself, and the prompts will
  53. scroll if there are more of them than will fit from the top of the popup
  54. to the bottom of the FoxPro screen.  Place one and *only one* option in the
  55. menu (it can be any height).  You needn't type any text into that option,
  56. it is simply a marker for the template. On the other hand, you can type
  57. anything you like in there: the template will ignore it.
  58.             
  59. Open the option definition window from the UI2 Menus menu and enter PROMPT
  60. FIELD <fieldname>, PROMPT FILES/FILES LIKE <skeleton>, PROMPT STRUCTURE
  61. code into line 1 of the Option Action Code box. Type a MESSAGE clause, if
  62. any, into the dedicated message slot.  (The SKIP clause is inapplicable
  63. with variable sized popups using fields or files as prompts).
  64.             
  65. All functions except digest_text(), from the WallSoft-supplied template
  66. libraries, are specifically written for this template.
  67.  
  68. More complete instructions for using this template are in January, 1990
  69. issue of DBMS magazine.  However, the code printed in that issue has
  70. errors which were editorially produced, and the listings on their BBS, at
  71. the time of this writing also had the errors.
  72.  
  73.